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PREFACE 


The software described in this document 
is furnished to purchaser under a 
license for uSe on a single computer 
system and can be copied (with inclusion 
of dec's copyright notice) only for use 
on such system, except as may otherwise 
be provided in writing by DEC. 


This document, DEC-ll-OROAA-B-D, describes the loading pro- 
cedures and operation of the Version VO 7 ROLLIN Utility Program for 
the PDP-11 and supersedes the document of the same title, 
DEC-ll-OROAA-A-D . The format of DECtapes and magtapes produced by 
ROLLIN Version V07 is not totally compatible with the format of 
previous versions. 

The Version VO 7 ROLLIN provides the following features in addi- 
tion to those previously available. 

a) Perform transfer operations between RP03 disk 
drives and from an RP03 disk drive to magtape. 


b) Format DECpack cartridges on RK11/RK03 and RK11/RK05 
disk drives and disk packs on RP11/RP03 disk drives 
prior to a transfer operation. 

c) Perform magtape to magtape copy operations. 

d) Perform a verify operation in conjunction with a 
“ copy operation. 

e) Perfom a write lock operation on an input RK03 or 
RK05 drive prior to a transfer operation. 


ROLLIN Version V07 does not support RK11/RK02 DECpack cartridges. 
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CHAPTER 1 


1 

LOADING PROCEDURES 


ROLLIN is a stand-alone program, which, when loaded into core, 
either from its distribution medium or from a ROLLIN formatted 
DECtape or magtape, overwrites any resident monitor present, and runs 
by itself in cpre. The ROLLIN program run is terminated and the 
Monitor is restored by following the procedure described in Chapter 4 . 
ROLLIN is used to transfer data quickly between a disk and either 
DECtape or magtape or between DECpack disk cartridges or disk packs. 
Disk devices handled by ROLLIN are the RPll^ RCll, RKll and 
RPll-C. ROLLIN assumes no file structure on disk or DECtape; trans- 
fers are performed in image mode. Magtapes are treated as file- 
structured devices in that each ROLLIN file is preceded by a DOS/ . 
BATCH-11 compatible file label (see section 3.2 for a description 
of magtape format) . 

When transferring data onto DECtape or magtape, ROLLIN auto- 
matically writes an initial record containing a tape sequence number 
called a veel label. For DECtape transfers, the reel label also 
contains the number of blocks of data transferred. The reel label 
guards against mounting tapes out of sequence when returning data to 
a disk device. 

Preceding all data records on a DECtape or the first file on a 
magtape, ROLLIN copies a core image of itself. This image permits 
ROLLIN to be bootstrapped from DECtape or magtape to load the remainder 
of the tape. 

1.1 DECTAPE BOOTSTRAP 

ROLLIN can be loaded from DECtape as follows; 

Mount the DECtape reel containing ROLLIN^ on DECtape unit 0. 

Set the transport switches to WRITE LOCK and REMOTE. 

Move the CPU ENABLE/HALT switch to its HALT position. 


^This does not imply a DOS/BATCH-11 or RSTS-ll-f ormatted tape, but 

. was previously dumped by ROLLIN or the tape on which 
distributed by DEC. ROLLIN tapes contain the ROLLIN image 
at the beginning of the tape (refer to Figure 3-1) . 
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If the BM792-YB Hardware Loader is on the system, 

Set the CPU Switch Register to 1731^f)7. 

Depress the CPU LOAD ADDRESS switch. 

Move the CPU ENABLE/HALT switch to its ENABLE position. 

Set the CPU Switch Register to 177344. 

Depress the CPU STARS? switch. 

If the MRll-DB Hardware Loader is on the system. 

Set the CPU Switch Register to 173120. 

Depress the CPU LOAD ADDRESS Switch. 

Move the CPU ENABLE/HALT switch to its ENABLE position. 
Depress the CPU START switch. 

ROLLIN is read from DECtape and started. It prints; 

ROLLIN V07 
£' 

and awaits a command. 

1.2 MAGTAPE BOOTSTRAP 

ROLLIN can be loaded from magtape as follows: 

Mount a magtape reel containing ROLLIN on magtape unit 
The tape must be at the load point. Turn the unit ON LINE. 
(For more detailed instructions see the magtape hardware 
manual . ) 

Move the CPU ENABLE/HALT Switch to its HALT position. 

If the BM792-YB Hardware Loader is on the system^ deposit the 
following routine in core via the console switch registers. 
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Address 

Contents 

10000 

12700 

10002 

172524 

10004 

5310 

10006 

12740 

10010 

60011 

10012 

105710 

10014 

100376 

10016 

5710 

10020 

100767 

10022 

12710 

10024 

60003 

10026 

105710 

10030 

100376 

10032 

5710 

10034 

100777 

10036 

5007 


Symbolic 
MOV #172524, Rjy 
DEC (R0) 

MOV #60011,- (R0) 

TSTB (R0) 

BPL .-2 
TST (R0) 

BMI .-20 

MOV #60003, (R0) 

TSTB (R0) 

BPL .-2 
TST (R0) 

BMI . 

CLR PC 


Set the CPU Switch Register to 010000. 

Depress the LpAD ADDR Switch. 

Move the CPU ENABLE/HALT switch to its ENABLE position. 
Depress the CPU START switch. 


If the MRll-DB Hardware Loader is on the system. 

Set the CPU Switch Register to 173136. 

Depress the CPU LOAD ADDRESS switch. 

Move the CPU ENABLE/HALT switch to its ENABLE position. 
Depress the CPU START switch. 

ROLLIN is read from magtape and started. It should print: 

ROLLIN V07 

r" " ^ 

and await a command. If the machine hangs in the RUN state at location 
10)2(34, a magtape error has occurred. Halt the machine, rewind the 
magtape manually, and restart the bootstrap procedure. 


1.3 LOADING ROLLIN FROM PAPER TAPE 


ROLLIN is distributed on a self-starting binary paper tape. 
This paper tape is loaded with the absolute binary loader which is 
described in section E.2 of the Paper Tape Software Programming 
Handbook . ROLLIN is automatically started and prints: 

ROLLIN V07 

w 

and awaits a command. 
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CHAPTER 2 
ROLLIN COMMANDS 


2 . 1 COMMAND FORMAT 


ROIiLIN prints a # character on the console teleprinter whenever 
it is ready to accept a command. ROLLIN commands are of the form. 


£devl : /option l<dev2 : /options 


or, more simply: 

£/ options 


where : 

devl : 
option 1 
dev2: 
/options 


is the output device designator 
can be the formatting switch option 
is the input device designator 
indicates one or more legal switch options 


The # character is underlined in examples to indicate that it is 
printed by ROLLIN rather than typed by the operator. The ROLLIN 
switches are listed for reference in Table 2-2 and explained in 
Chapter 3. 


Legal device designators are shown in Table 2-1. 

Table 2-1 
Device Designators 


Device Designator 


Device Medium 


DC: 

DF: 

DKn: 

(n « jZf to 7) 


An RCll disk controller with one 
RS64 disk unit (one platter) and a 
capacity of 64K processor words. 

An RFll disk controller with one 
RSll disk unit (one platter) and a 
capacity of 256K processor words. 

An RKll disk controller with one 
to eight RK)i3 or RK05 drive 
units. One RKjJ3/05 DECpack cartridge 
has a capacity of 1200K processor 
words. DK: is equivalent to DKj/: 
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Table 2-1 (Cont’dJ 
Device Designators 


Device Designator Device Medium 

DPn: An RPll-C disk controller with one 

(n = 0 to 7) to eight RP03 disk drive units. 

One RP)Zf3 formatted disk pack has a 
capacity of 20^000K processor words. 


DTn: One TCll control unit with up to 

(n = 0 to 7) four TU56 dual transports or eight 

DECtape drive units. Each drive is 
designated by a unique number 
selectable between zero and seven. 

MTn: filename One TMll control unit with up to 

(n * 0 to 7) eight TU10 magtape transports. 

Each transport is designated by a 
unique unit number selectable between 
zero and seven. A filename (from 
one to six alphanumeric characters) 
must be specified for disk to 
magtape transfers but not for magtape 
copy operations. 


An example of a ROLLIN transfer command is shown below; 
£MT0:DAT8<DC: 

The above command dumps the entire contents of an RS64 disk onto a 
magtape file called DAT8 on the magtape reel mounted on unit 0. 


2.2 EDITING COMMANDS TO ROLLIN 


Editing procedures for ROLLIN command strings are identical to 
those for DOS/BATCH-11 and RSTS-11 command strings. 

While typing a command line, the operator can use the RUBOUT key 
repeatedly to delete preceding characters. The entire catimand line 
can be deleted by typing CTRL/U. 

When ROLLIN is printing on the teleprinter, typing CTRL/0 inhibits 
further printing. 
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Table 2-2 


ROLLIN Option Switch Descriptions 


Option 

Switch 

/BOOT: dev 


/DATE ; dd-minm-yy 


/FIND 


/FORMAT 


yHELP 

/NOLABEL 


/NUMBER :n 


Abbreviation Meaning 

/BO: dev This general-purpose bootstrap 

switch, which loads the first 256 
words of core from the device and 
then branches to location 0, is 
used to bootstrap DOS/BATCH-11 or 
RSTS-11? for example: 


#/BO:DK 

loads and starts a DECpack DOS/ 
BATCH-11 or RSTS-11 system. 

/DA:dd-mmm-yy Used in writing the FILE LABEL on 
magtape. /DA causes the specified 
date to be entered in the FILE 
LABEL. The format for the day is 
day-month-year; for example: 

#/DATE:l-FEB-73 

/FI Used with magtape only. When 

reading from magtape, /FI rewinds 
the tape and searches for the 
specified file. When dumping to 
magtape, /FI causes the tape to 
skip past all the files previously 
written on the tape. 

/FO Used, on the output side of a transfer 

command string, to format a DECpack 
cartridge on an RKfl3/id5 disk drive or 
a disk pack on an RP11-C/RP03 disk 
drive before a transfer operation 
begins. 


/HE Types a brief explanation of 

ROLLIN options on the console. 

/NO On dumping disk to DECtape, this 

option inhibits the reel label 
record from being written (see 
sections 3.1 and 3.2 for a de- 
scription of the reel label and 
instances of use of the /NO switch) . 

/NU:n The decimal number specified by n 

is the total number of units of 
disk space to transfer. A unit of 
disk space is IK processor words, 
where K=1024. The maximum value 
for n is determined by the type 
of disk drive as shown below. 
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Table 2-2 (Cont.d) 

ROLLIN Option Switch Descriptions 


Option 

Switch 


/PLATTERS :n 


/RWIND 


/SKIPrn 


/TRACK :n 


/VERIFY 


/WLOCK 


Abbreviation 


Meaning 

Maximum n 

Drive Ty pe (units of IK words) 


RCll 

RFll 

RK^I3/i2f5 

RP03 


64 

256 

1200 

20000 


If the /NU switch value is not 
specified^ the entire disk is used. 


/PL:n 


/RW 


/SK:n 


/TR:n 


/VE 


/WL 


For use with RFll or RCll disks 
only^ n is the number of disk platters 
to load or dump. /PLATTERS:! is 
always assumed if not specified. 

When reading or writing magtape, 
this switch causes the tape to be 
rewound before use. 

When reading or writing magtape, 
this switch causes the tape to skip 
past n end-of-file marks before 
starting a read or write. 

The decimal number specified by n 
is the unit of disk space at which 
the transfer operation begins. A 
unit of disk space is IK processor 
words, as is defined in the des- 
cription of the /NU:n switch in this 
table. If the /TR switch value is 
not specified, the first unit of 
disk space on the drive is used. 

The first unit is defined as /TR:0. 

Used only in image copy operations 
to ensure that the copy can be 
read and, when read, is the same as 
the original. 

Used with a DECpack device designator 
to force a write lock on an input 
drive unit. 
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CHAPTER 3 


TRANSFER OPERATIONS 

3.1 DISK/DECTAPE OPERATIONS 

DECtape is a block-structured device. DECtape reels contain 
578 blocks, each 256 words in length. When ROLLIN writes a DECtape, 
it dumps its own image onto blocks /Zf to 19, writes a reel label onto 
block 2jJ, then dumps data from the disk onto blocks 21 through 532. 
This means that 128K words of data can be kept on each tape. Hence, 
an RFll controller with one RSll disk requires two DECtapes, while 
an RKJJ3 or RK05 DECpack cartridge requires ten DECtapes for a com- 
plete dump. 

When a disk is restored from DECtape, ROLLIN checks the label 
block on each reel to ensure that the tapes are used in the proper 
sequence, and that the number of blocks restored does not exceed the 
number of blocks dumped. If this is not the case, an error message 
is printed. 

3.1.1 Disk to DECtape Dump 

To dump a disk to DECtape, simply type DT: as the output device 
and the disk device designator as the input device. For example: 

£DT:<DKj2f: 

dumps an RK03 or RK05 disk cartridge 0 onto ten DECtapes (unit 0 would 
be used first, then units 1,2, 3, 4, 5, 6 and 7, the ninth tape would then 
go back to unit 0 and the tenth to unit 1) • This is the normal order 
for using tapes, the user could override this by typing the actual 
units to use. For example: 

£DT2 : ,DT0:<DF: 

would dump the RFll disk onto two tapes, using unit 2 first, and then 
unit 0 * 
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The /NOLABEL switch option is used when writing over the first part of 
a DECtape previously written by ROLLIN. For example / suppose we have 
just patched the DOS/BATCH-11 monitor. This monitor normally resides on 
the first 28K of the RFll disk. Now suppose we want to dump this 
patched monitor on the first 28K of an earlier disk dump. This can 
be done by mounting the first dump tape on unit loading ROLLIN, 
and typing the following command 

#DT0 : <DF : /NUMBER : 2 8/NOLABEL 

This will write out the first 28K of the disk without rewriting the 
DECtape label. Now, when we restore from this tape, ROLLIN will read 
the entire tape, and not just the first 28K. 


3.1.2 Restoring Disk from DECtape 

This is simply the reverse of the dump operation and takes a 
similar command. For example : 

£DF:<DT: 

would restore the RFll from two reels of DECtape on units 0 and 1. 


As before, reel numbers can be given explicitly, if desired; 
for example 

£DF:<DT1: ,DT2 : ,DT3 : ,DT4 : /PLATTERS: 2 

would load a 2-platter RFll disk (512K) from four DECtapes, mounted 
on units 1, 2, 3, and 4, in that order. 


3.2 DISK/MAGTAPE OPERATIONS 


Magtapes are written by ROLLIN with S00 BPI density and odd 
parity. On 9-channel drives each 16-bit word takes two frames of 
tape. On 7-channel drives core-dump mode is used, so each 16-bit 
word takes four frames of tape. 
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Each dump operation writes one file on the tape. This file 
normally consists of a T-’Word file label record containing the 
filename (always with the .ROL extension), UIC (always [1,1]), 
protection code (always 155 decimal), and date. This is followed by 
a 256-word reel label record that contains the reel sequence number 
for this file. Following this are the actual data records. Each 
data record, except possibly for the final one, contains 4K 
words (8K bytes) of data. ROLLIN closes the file by writing 
three end-of-file (EOF) records, one to end the file and two 
more to indicate the end-of-data (EOD) on the magtape. ROLLIN then 
backspaces over two of the EOF records to leave the tape cor- 
rectly positioned for performing another dump. There is one 
exception to this file format. If, before writing the file 
label, the tape is positioned at the load point (beginning-of- 
tape) , two records are written immediately following the file 
label. These two records contain a bootstrap and an image of 
ROLLIN, and they are used in conjunction with the procedure given in 
Chapter 1 to load ROLLIN from magtape. 


The file label is DOS/BATCH-11 compatible, permitting mixing of 
ROLLIN files and DOS/BATCH-11 files on a single tape and cataloging 
of the tape via the /DI option of DOS/BATCH-11 PIP. However, DOS/ 
BATCH-11 records are required to be 256 words in length, while ROLLIN 
makes more efficient use of the tape by writing 4 K words in each 
record. This means that ROLLIN files cannot be read in file structured 
mode by DOS/BATCH-11 (READ/WRITE) . TRAN can, of course, be used with 
ROLLIN files. (See the DOS/BATCH-ll Monitor Programmer’s Handbook ) . 


3.2.1 Disk to Magtap_e Dumps 

To illustrate dumping from disk to magtape, suppose a system 
had one RFll disk and two RKjfl5 drives. These could be dumped as 
three files by the following commands; 

#MT0 : DFDMP<DF : /RWIND/DATE : l-FEB-7 3 
fMT0 : DKJ?DMP<DK0 ; /DATE ; l-FEB-7 3 
fMTja : DK1DMP<DK1 : /DATE : l-FEB-7 3 
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The filename must be specified with magtape; the date is optional 
but should be specified. The magtape now has three files on it: 
DFDMP.ROL, DKJJDMP.ROLf DKlDMP.ROL. Note that the file extension is 
never specified by the user; the extension is always ROL. 

This assumes that a tape has been mounted, WRITE ENABLEd, 
on unit jJ. To use another unit simply designate MTl: , ^2 : , 

etc. in place of MTjZf: . 

A large 2400“foot reel can easily hold this much data; however, 
a small 600-foot reel would not have enough room for a complete dump 
of the second RK05. When ROLLIN detects the end-of-tape, it 
backspaces over the last data record, writes three end-of-file 
records, and prints the following message: 

TAPE FULL, TYPE M TO MOUNT ANOTHER REEL AND CONTINUE, ANYTHING 
ELSE TO ABORT REQUEST: 

If another tape is available, type M followed by the RETURN key. 

ROLLIN now prints the following message: 

TYPE RETURN TO CONTINUE WHEN READY. 

Now mount the new tape (it must be on the same unit number) . Type the 
RETURN key and ROLLIN will finish the dump. 

After a tape has been dumped it is recommended that the WRITE 
ENABLE ring be removed. 

Figure 3-1 illustrates the format of a tape with two files on it, 
the first of which is a dump of an RSll disk, and the second is a dump 
of an RK05 DECpack disk cartridge. 
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LOAD 

POINT 


FILE LABEL 

ROLLIN BOOT 

ROLLIN 

IMAGE 

REEL LABEL 

4K DATA 
RECORD 

• 

4K DATA 
RECORD 

EOF 

FILE LABEL 

REEL LABEL 

4K DATA 
RECORD 

I 


EOF 

EOF 


EOF 




•N 


RSll DUMP 
64 4K RECORDS 


RKjafS DUMP 
399 4K RECORDS 


Figure 3-1 ROLLIN Magtape Format 
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If a magtape reel contains data files (either ROLLIN core- 
image files or DOS/BATCH-11 files) and the user desires to add more 
data files, the /SKIP:n switch can be used to read over n files on the 
reel and dump the data in the proper position. For example, the 
command string shown below 

£MT0 : DCDMP<DC : /RWIND/DATE : 2 7-DEC-7 3/SK : 3 

causes the reel of magtape on unit j2f to be rewound first. A search 
is performed for the end of the third file on the reel. The contents 
of the RS64 disk are dumped to a fourth file on the reel which is 
named DCDMP.ROL. The date 27-DEC-73 is placed in the file label 
record. 

3.2.2 Restoring Disk from Magtape 

Returning to our illustrative case, the three files mentioned 
above could be restored from magtape by the following commands: 

IDF : <MT0 : DFDMP/F IND 
fDKj? : <MTj2f : DK0DMP 
IDKI: <MT0:DK1DMP 

Here, the /FIND switch rewinds the tape and searches for 
the file DFDMP.ROL which would in this example be the first file on 
the tape. While /FIND may always be used, if you are certain that 
the tape is correctly positioned, omitting /FIND will greatly speed 
the restoring process since the tape is not rewound. ROLLIN will, 
in any case, verify that the filename is the same as the specified 
name, and the extension is ROL, and indicate the error if it is 
not. 


This again assumes that the tape dumped by the commands given 
in Section 3.2.1 has been mounted on unit 0. If an end-of-^file is 
encountered during the read, as would be the case with a 6 00-^foot 
reel, then ROLLIN will ask for another reel by printing; 

END-OF-FILE DURING READ, TYPE 

M TO MOUNT ANOTHER REEL, OR K TO KILL REQUEST: 
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If the second reel is available / respond M followed by the RETURN 
key. ROLLIN now prints the following message: 

TYPE RETURN TO CONTINUE WHEN READY. 

Now dismount the current tape and mount the continuation tape 
(it must be on the same unit number^ as before) . Type return and 
ROLLIN will finish the read. 

3.3 COPY AND VERIFYING OPERATION 

The ROLLIN program allows the user to perform a copy operation 
and, optionally, to specify a verify action in conjunction with the 
copy operation. The verify action is specified by use of the 
/VERIFY switch in the copy command string. Devices upon which a copy 
is performed are magtape drives, the RKJ2f3 or RKJ2f5 disk drives, and 
RP11-C/RP03 disk drives. 

In the execution of the copy operation, no header or label 
information is automatically written. An exact image of the medium 
on the input device is transferred to the same type medivim on the 
output device. The verify action, if specified, is performed as a 
second pass of the copy operation. The following three sections 
describe procedures to perform copy operations for magtape, DECpack 
and disk pack devices. 

3.3.1 Magtage Procedures 

To copy a magtape, mount the input reel with the write ring 
removed on drive unit )2f and mount the reel on which the copy is to 
be written on unit 1, with the write ring attached. If the input 
reel is written in 9-track format, it must be mounted on a 9-track 
drive. Reels written on a 7-track drive must be mounted on a 7-track 
drive. A copy can be made on either a 7-track or 9-track drive, 
regardless of the format of the input. The 9-track format, however, 
has twice the information storage capacity of the 7-track format 
at the same density. Also, 9-track drives are always written and 
read at a density of 800 BPI. 
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A copy operation with a verify action is accomplished as follows : 


#MTl:<MTi?:/VE 

When the copy operation is completed, ROLLIN prints the following 
message: 


STARTING VERIFICATION PASS 


The verification action ensures that the copy can be read, and 
that, when read, it is identical to the input. If multiple copies 
are to be made of the same input reel, it is suggested that the copy 
be used as input to the subsequent copy operation. Such a course 
of action lessens wear on the original master reel. The unit number 
of the previous copy is then used for input, the original reel is taken 
down and a new reel mounted in its place, and the drive unit number 
of the new reel is used for output. 

Ccxnpletion of the verification action is signalled by a pound 
sign (#) being printed at the terminal. If any other messages are 
printed before the pound sign (#) is printed, the copy operation 
was not successful. The unit number of the device causing the fatal 
error is printed in the error message. 

3.3.2 DECpack Procedures 

Copies of DECpack cartridges can be made by using either RKj2f3 
or RK05 disk drives. To safeguard the input cartridge, the drive 
on which it is mounted can be write locked by using the /WL 
switch, either in a single action or in combination with the copy 
command string. Either of the following two commands is acceptcd)le. 

#DKl:/WL 

fDKi2f:<DKl:/WL 

To format a cartridge prior to writing a copy to it, the user 
specifies the /FORMAT switch on the output side of the command string. 
Verification can be specified also by using the /VE switch. The follow- 
ing command string demonstrates the use of the /FORMAT and /VE switches 
with write lock. 

£DK1 : /FO<DK0 : /WL/VE 
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Upon initialization of execution of the above command string, the 
following message is printed. 

STARTING RK FORMAT PASS 


When formatting is completed and copying begins, the follow- 
ing message is printed. 

END RK FORMAT PASS 

When copying is complete, the following message is printed. 

STARTING VERIFICATION PASS 

If any other messages are printed prior to the pound sign (#), 
the copy operation was not successful. The error message indicates 
the drive unit number on which the error occurred. 

Disk Pack Procedures 

The user copies a disk pack mounted on an RP11-C/RP)?3 drive 
in the same manner as he copies DECpack cartridges. He may use 
the /FORMAT and /VERIFY switches similarly, with one variation. 
Formatting a disk pack on an RP03 drive requires enabling of the 
format toggle switch on the RPll-C controller. The ROLLIN program 
prints messages which instruct the user to set and disable the for- 
mat switch. The following command string causes the disk pack mounted 
on RP03 drive unit 1 to be formatted and an image copy to be trans- 
ferred to it and verified from RPJZf3 drive unit 0. 

#DP1:/FO<DP0:/VE 

The messages informing the user of the actions taken are the 
same as those occurring when a DECpack cartridge is formatted, copied 
and verified. The only exception is that the messages to set and 
disable the format toggle switch on the RPll-C controller replace 
the messages STARTING RK FORMAT PASS and END RK FORMAT PASS . 
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CHAPTER 4 


RESTORING THE MONITOR 


The ROLLIN progreum runs in a stand-alone state in the memory 
of a PDP-11 computer. When the ROLLIN program run is completed , the 
user may restore the DOS/BATCH-11 or RSTS-11 Monitor by using the 
/BO switch and indicating the device which contains the monitor, as 
in the following example, 

£/BO:DK 
BATCH V08-iai2 
$ 

The above command string caused the BATCH-11 Monitor to be read 
from RK03 or RK05 drive unit 0 and loaded into core. The identification 
message indicates the monitor is successfully bootstrapped and the user 
can follow the proper login procedures. The /BO switch is described in 
Table 2-2. 
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CHAPTER 5 


ERROR AND INFORMATION MESSAGES 

Error messages printed by the ROLLIN program are succinct and require 
little interpretation by the operator. 

SYNTAX ERROR, COMMAND IGNORED. 

DISK ERROR, — REQUEST KILLED. 

THE REEL LABEL INDICATES THAT THE REST OF THE TAPE WAS 
NOT DUMPED, TYPE K TO KILL REQUEST AT THIS POINT, ANYTHING 
ELSE TO PROCEED IN THE FACE OF DANGER; 

LABEL INDICATES THAT THE TAPE IS OUT OF SEQUENCE. TYPE P TO PROCEED, 
M TO MOUNT ANOTHER REEL, OR K TO KILL REQUEST: 

PREMATURE END-OF-FILE, REQUEST KILLED. 

TAPE PULL, TYPE M TO MOUNT ANOTHER REEL AND CONTINUE. 

ANYTHING ELSE TO ABORT REQUEST; 

SELECT ERROR ON MTn; 

MAGTAPE WRITE PROTECT ERROR. 

FATAL MAGTAPE ERROR 

SPECIFIED DEVICE DOES NOT EXIST. 

REACHED END-OF-DATA ON SKIP, OPERATION KILLED. 

HUNG DEVICE DTn 

TYPE K TO ABORT, ANYTHING ELSE TO TRY AGAIN: 

MOUNT TAPE ON DTn, TYPE RETURN TO CONTINUE WHEN READY. 

TOO FEW DECTAPE UNITS WERE SPECIFIED. REQUEST KILLED. 

DISK ERROR ON UNIT n — REQUEST KILLED. 

END OF FILE DURING READ, TYPE M TO MOUNT ANOTHER REEL, 

OR K TO KILL REQUEST: 

MAGTAPE FILENAME DOES NOT MATCH SPECIFIED NAME. 

CAN'T FIND SPECIFIED FILE ON TAPE 
NO OUTPUT FILENAME SPECIFIED. 

MAGTAPE RECORD TOO LONG FOR BUFFER 

VERIFICATION ERROR-COPY IS BAD 

VERIFY IS not implemented FOR THIS COMMAND 

ERROR DURING FORMAT PASS - RESTART 

DISK NOT READY - TYPE CR TO TRY FORMAT AGAIN 
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HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software, as well as programming notes, software problems, 
and documentation corrections are published by Software Information Service in the following 
newsletters. 

Digital Software News for the PDP-8 and PDP-12 
Digital Software News for the PDP-11 
Digital Software News for 18-bit Computers 

These newsletters contain information applicable to software available from Digital's Software 
Distribution Center. Articles in Digital Software News update the cumulative Software Per- 
formance Summary which is contained in each basic kit of system software for new computers. To 
assure that the monthly Digital Software News is sent to the appropriate software contract at your 
installation, please check with the Software Specialist or Sales Engineer at your nearest Digital 
office. 

Questions or problems concerning Digital's software should be reported to the Software Specialist. 
Incases where no Software Specialist is available, please send a Software Performance Report 
form with details of the problems to: 

Digital Equipment Corporation 
Software Information Service 
Programming Department 
Maynard, Massachusetts 01754 

These forms, which are provided in the software kit, should be fully filled out and accompanied 
by Teletype output as well as listings or tapes of the user program to facilitate a complete inves- 
tigation. An answer will be sent to the individual and appropriate topics of genera I in- 
terest will be printed in the newsletter. 

Orders for new and revised software manuals, additional Software Performance Report forms, and 
software price lists should be directed to the nearest Digital Field office or representative. USA 
customers may order directly from the Software Distribution Center in Maynard. When ordering, 
include the code number ond a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library and publishes a cata- 
log of programs as well as the DECUSCOPE magazine for its members and non-members who request 
it. For further information, please write to: 

Digital Equipment Corporation 
DECUS 

Programming Department 
Maynard, Massachusetts 01 754 
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READER’S COMMENTS 


Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness 
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